RSS2RSC 1.0

Copyright © 1998 Guillaume Sabouraud & Alan Richey (RMR)

Read this document carefully. It's not long and necessary to avoid any runtime problem. Users of previous versions of this program should read the historic section to know quickly about the latest changes.

This utility is freeware but we ask you to add something in the credits section of your help file or about screen if you use it for any freeware or shareware that you distribute and for which you have used RSS2RSC or any other RSCTool..

Historic

The purpose of this complementary RSCtool is to compile a simple resource definition file in the Symbian rss format that usually has to be compiled on a PC computer with the Symbian EPOC emulator tools.

This very first release has quite limited features but it can be improved very easily and that will depend on the demand...

V 1.0 : December 1998. First public release

How it works

This program takes a standard rss file and compiles it to the corresponding rsc file.

When you run RSCcompiler for the first time in a directory, it will generate an ini file. Be careful to press the "FilePaths..." button to set the source and target paths before running the compiler.

The following syntax lines are recognised ; any other will be ignored :

• The name statement that is used once at the begining of the file :
  NAME XXXX

• The standard String resources :
  RESOURCE TBUF constant_name {buf="String";}

The mean processing time that has been measured on a Series 5 during a trial is around 5 seconds for more than 250 resources (rss file size was 13kb and compiled resource file was 5kb) when ran on a CF, it is 1s shorter on C drive due to writing times.

Usage

Main screen : you get there a reminder of the current paths. You also have 3 buttons to call the path preferences dialogs, to run the program, or to quit.

Paths preferences : you have to choose there the path of your rss file and the two paths of the output rsc and constant definitions files.

It is recommended that you run this program in the directory in which you have the initial data file because this programs automatically displays a file choice dialog starting at the folder in which it is located.

WARNING ! : there is no error handling so far but it can be added if necessary. I will appreciate any feedback to improve this utility.

Future plans

Other features will be added along with users suggestions.

For any further information or suggestions, contact the either author : "Guillaume Sabouraud "
"Alan Richey "